home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / stiff2ps.z / stiff2ps
Text File  |  1998-10-30  |  18KB  |  331 lines
  1.  
  2.  
  3.  
  4. SSSSTTTTIIIIFFFFFFFF2222PPPPSSSS((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       SSSSTTTTIIIIFFFFFFFF2222PPPPSSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      stiff2ps - convert a Stream TIFF (STIFF) image file to PostScript
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssttttiiiiffffffff2222ppppssss [----OOOO filename] [----LLLL filename] [----BBBB]
  13.               [----CCCC colorspace] [----FFFF] [----ffff] [----rrrr angle]
  14.               [----pppp imageRes] [----zzzz factor] [----nnnn nCopies]
  15.               [----GGGG g0[,g1,g2[,g3]]] [----NNNN nUpX[,nUpY]]
  16.               [----IIII filename] [----bbbb kbytes] [----hhhh] [----DDDD]
  17.               [STIFFImageFilename ...]
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _s_t_i_f_f_2_p_s converts raster files in Stream TIFF (STIFF) image format into
  21.      PostScript code. The program provides a number of image transformation
  22.      capabilities including zooming, rotation and gamma correction. In
  23.      addition, _s_t_i_f_f_2_p_s provides the capability to display multiple images on
  24.      a single physical page.
  25.  
  26.      _s_t_i_f_f_2_p_s supports conversion of all standard STIFF image file colorspaces
  27.      (i.e. K, W, RGB, CMY, YMC, CMYK, YMCK, KCMY) and data formats (i.e.
  28.      planar and chunky). _s_t_i_f_f_2_p_s supports images with 1, 4, 8 and 16 bits per
  29.      sample. For images with 16 bits per sample, _s_t_i_f_f_2_p_s will assume that the
  30.      full bit range is being used (i.e. data values range from 0 thru 65535
  31.      inclusive). If the STIFF tags STMinSampleValue or STMaxSampleValue are
  32.      found in the image file, the values of these tags will be used as the
  33.      image data range. This allows 16 bit images to contain data with
  34.      intermediate ranges (e.g. 12 bits per sample ranging from 0 thru 4095) to
  35.      be processed by _s_t_i_f_f_2_p_s. The PostScript image data written by _s_t_i_f_f_2_p_s
  36.      will be at the same bits per sample as the input image with the exception
  37.      of 16 bits per sample input images. These images will be scaled to 8 bits
  38.      per sample which is the highest sample depth available on PostScript
  39.      Level 1 interpreters.
  40.  
  41.    CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
  42.      Typically, _s_t_i_f_f_2_p_s expects at least one STIFF image file to be specified
  43.      as input on the command line after all option switches. If no image file
  44.      is specified on the command line, _s_t_i_f_f_2_p_s will read from the standard
  45.      input.  By default, _s_t_i_f_f_2_p_s assumes that its output should be written to
  46.      the standard output and messages should be written to standard error.
  47.  
  48.      ----OOOO _f_i_l_e_n_a_m_e
  49.                Specifies the name of the file to which the PostScript output
  50.                will be sent.  If the ----OOOO option is not specified, output will
  51.                be sent to the standard output.
  52.  
  53.      ----LLLL _f_i_l_e_n_a_m_e
  54.                Specifies the name of the file to which error, warning and
  55.                informational messages are to be written. If the file specified
  56.                already exists, any messages generated by _s_t_i_f_f_2_p_s will be
  57.                appended to the end of the file.  If the ----LLLL option is not
  58.                specified, message output will be sent to standard error.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSTTTTIIIIFFFFFFFF2222PPPPSSSS((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       SSSSTTTTIIIIFFFFFFFF2222PPPPSSSS((((1111))))
  71.  
  72.  
  73.  
  74.      ----BBBB        Specifies that binary PostScript should be output where
  75.                applicable. The majority of the output from _s_t_i_f_f_2_p_s is bitmap
  76.                image data. By default this data is output as ASCII hexadecimal
  77.                values. Specifying ----BBBB will output this image data as binary
  78.                values thereby cutting in half the number of bytes of
  79.                PostScript data output. However, binary data output should only
  80.                be used when the communications channel between _s_t_i_f_f_2_p_s and
  81.                the PostScript interpreter can accept 8-bit data. This
  82.                precludes the use of the ----BBBB switch when transmitting output
  83.                over serial connections.
  84.  
  85.      ----CCCC _c_o_l_o_r_s_p_a_c_e
  86.                Specifies the output data colorspace. The value of _c_o_l_o_r_s_p_a_c_e
  87.                may be one of the following: wwww (black and white), the default,
  88.                ccccmmmmyyyykkkk, or rrrrggggbbbb. The PostScript produced by ccccmmmmyyyykkkk and rrrrggggbbbb can only
  89.                be interpreted by a Level 2 PostScript interpreter or a Level 1
  90.                interpreter with the CMYK color extensions (e.g. _p_s_r_i_p(_1)). The
  91.                PostScript produced by wwww can be sent to any Level 1
  92.                interpreter. The colorspace conversion equations used by
  93.                _s_t_i_f_f_2_p_s are:
  94.  
  95.  
  96.                W to RGB: r = g = b = w
  97.  
  98.                W to CMYK: c = m = y = 0; k = 1 - w
  99.  
  100.                RGB to W: w = 0.299 r + 0.587 g + 0.114 b
  101.  
  102.                RGB to CMYK:
  103.                ci = 1 - r; mi = 1 - g; yi = 1 - b
  104.                k = min(ci, mi, yi)
  105.                c = ci - k; m = mi - k: y = yi - k
  106.  
  107.                CMYK to RGB and to W:
  108.                ri = 1 - c
  109.                gi = 1 - m
  110.                bi = 1 - y
  111.                r = (ri > k)? ri - k: 0
  112.                g = (gi > k)? gi - k: 0
  113.                b = (bi > k)? bi - k: 0
  114.                w = 0.299 r + 0.587 g + 0.114 b
  115.  
  116.      ----FFFF        Specifies that the image should be oriented so that it best
  117.                fits the page.  That is, the image is oriented such that its
  118.                longer dimension is parallel with the longer dimension of the
  119.                paper. If ----FFFF is specified, any rotation specified by the ----rrrr
  120.                switch is ignored. By default the image is oriented with zero
  121.                degrees of rotation unless the ----rrrr switch specifies a different
  122.                rotation.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSTTTTIIIIFFFFFFFF2222PPPPSSSS((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       SSSSTTTTIIIIFFFFFFFF2222PPPPSSSS((((1111))))
  137.  
  138.  
  139.  
  140.      ----ffff        Specifies that the output image should be flipped (mirrored)
  141.                about the vertical axis. This flag is useful when creating
  142.                transparencies.  Note that flipping of the image is performed
  143.                after any rotation. Therefore, the image is always flipped
  144.                about the vertical axis.
  145.  
  146.      ----rrrr _a_n_g_l_e  Specifies that the image is to be rotated by _a_n_g_l_e degrees.
  147.                _a_n_g_l_e may be any positive or negative integer value. Positive
  148.                rotations are counter-clockwise measured from the horizontal
  149.                axis. The default rotation angle is 0. Note that rotation is
  150.                performed before any image flipping (----ffff). The ----rrrr switch is
  151.                ignored if the best-fit switch ----FFFF is specified.
  152.  
  153.      ----zzzz _f_a_c_t_o_r and ----pppp _i_m_a_g_e_R_e_s
  154.                Each of these switches provides scaling of the original image.
  155.                The two switches are mutually exclusive.
  156.  
  157.                The ----zzzz switch provides image zooming.  _f_a_c_t_o_r is a positive
  158.                floating point value typically between 0.0 and 1.0. A zoom
  159.                factor of 1.0, the default, indicates that the image should be
  160.                scaled to fit the entire page while preserving the original
  161.                image's aspect ratio. A zoom factor of 0.5 would produce an
  162.                image sized to 50% of that needed to fit the entire page. A
  163.                zoom factor of 0.0 produces no zooming. Instead the image is
  164.                output at its original size.
  165.  
  166.                If an image must be sized based on a given resolution, the ----pppp
  167.                switch should be specified in place of the ----zzzz switch. The
  168.                _i_m_a_g_e_R_e_s argument specifies the resolution used to size the
  169.                image in dots per inch. This resolution is independent of the
  170.                output device resolution. For example, suppose an image is one
  171.                inch by one inch when displayed on a 96 dpi monitor. In order
  172.                to print that image on a 300 dpi printer so that it remains one
  173.                inch by one inch the ----pppp switch would be specified with an
  174.                _i_m_a_g_e_R_e_s of 96.
  175.  
  176.      ----nnnn _n_C_o_p_i_e_s
  177.                Specifies the number of copies to produce of each page.
  178.                Specifying this switch simply sets the value of the ####ccccooooppppiiiieeeessss
  179.                variable in the output PostScript code. The value of this
  180.                variable is used by the PostScript operator sssshhhhoooowwwwppppaaaaggggeeee to
  181.                determine the number of output copies to produce. By default
  182.                the ####ccccooooppppiiiieeeessss variable is not specified and the number of copies
  183.                then defaults to one.
  184.  
  185.      ----GGGG _g_0[,_g_1,_g_2[,_g_3]]
  186.                This switch provides gamma correction of the input image data.
  187.                The gamma function is:
  188.  
  189.                corrected value = value ^ gamma
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SSSSTTTTIIIIFFFFFFFF2222PPPPSSSS((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       SSSSTTTTIIIIFFFFFFFF2222PPPPSSSS((((1111))))
  203.  
  204.  
  205.  
  206.                The gamma value (_g_0, etc.) is typically a value between 0.0 and
  207.                3.0. A gamma value less than 1.0 will tend to lighten the image
  208.                while a value greater than 1.0 will tend to darken the image. A
  209.                gamma of 1.0 will leave the image data unchanged.  The gamma
  210.                value may be specified for each input color channel
  211.                individually or as a group. If _g_0 is the only gamma value
  212.                specified, this value will be applied to all input channels.
  213.                Note that a black and white image contains one input color
  214.                channel, an RGB image contains three input channels and a CMYK
  215.                image contains four input channels. Note that gamma correction
  216.                of one bit per sample images has no meaning and therefore the
  217.                ----GGGG switch has no effect for these images. The default gamma
  218.                value is 1.0 for all channels.
  219.  
  220.      ----NNNN _n_U_p_X[,_n_U_p_Y]
  221.                _s_t_i_f_f_2_p_s allows multiple STIFF image files to be specified on
  222.                the command line. By default, each image is output on a
  223.                separate physical page.  The ----NNNN switch provides the capability
  224.                to divide up one physical page into multiple virtual pages.
  225.                This is often called n-up display. Using n-up, multiple image
  226.                files can be displayed on the same physical page. If only the
  227.                _n_U_p_X value is specified the physical page will be divided into
  228.                nUpX by nUpX virtual pages. If both _n_U_p_X and _n_U_p_Y are
  229.                specified, the physical page will be divided into _n_U_p_X by _n_U_p_Y
  230.                virtual pages.  Images are displayed in row (horizontal) major
  231.                order.  Note that _n_U_p_X is measured along the horizontal, x,
  232.                axis. For an 8.5 by 11.0 inch page, the horizontal axis is the
  233.                short dimension in portrait mode and the long dimension in
  234.                landscape mode. Rotation is performed on each image
  235.                individually and best-fit orientation is determined for each
  236.                image individually. Zooming is relative to the virtual page
  237.                size. Note that image replication is not performed. The number
  238.                of images specified on the command line is the number of images
  239.                displayed in the virtual pages.
  240.  
  241.      ----IIII _f_i_l_e_n_a_m_e
  242.                _s_t_i_f_f_2_p_s places a PostScript code prolog at the start of the
  243.                output file.  By default, this prolog code is read from the
  244.                file /_u_s_r/_l_i_b/_p_r_i_n_t/_d_a_t_a/_P_S_I_m_a_g_e_P_r_o_l_o_g.  The ----IIII switch allows a
  245.                different prolog file to be specified. This switch is not
  246.                intended for general use.
  247.  
  248.      ----bbbb _k_b_y_t_e_s _s_t_i_f_f_2_p_s allocates buffers for performing input/output and
  249.                conversion operations. By default, the total size of these
  250.                buffers is limited to 64 KBytes.  The ----bbbb switch allows a new
  251.                buffer size to be specified. The buffer size is specified in
  252.                multiples of 1024 (one K) bytes. For example, specifying 128
  253.                KBytes for buffering would permit approximately 21 rows of a
  254.                2048 pixel wide 8 bit per sample RGB image to be buffered. Note
  255.                that internally _s_t_i_f_f_2_p_s buffers data in terms of image rows.
  256.                If the _k_b_y_t_e_s is less than that required to buffer one image
  257.                row, _k_b_y_t_e_s will be ignored and one row will be buffered.
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. SSSSTTTTIIIIFFFFFFFF2222PPPPSSSS((((1111))))                      IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo                       SSSSTTTTIIIIFFFFFFFF2222PPPPSSSS((((1111))))
  269.  
  270.  
  271.  
  272.      ----hhhh        Prints a program usage message to the standard error. This
  273.                usage message also lists the currently supported output
  274.                configurations.
  275.  
  276.      ----DDDD        Specifies verbose output for debugging purposes.
  277.  
  278. NNNNOOOOTTTTEEEESSSS
  279.      1.   The PostScript output produced by _s_t_i_f_f_2_p_s conforms to the Adobe
  280.           PostScript Document Structuring Conventions Version 3.0 as specified
  281.           in Appendix G of the "PostScript Language Reference Manual", 2nd
  282.           edition.
  283.  
  284.      2.   The PostScript output produced by _s_t_i_f_f_2_p_s wraps the input bitmap
  285.           image data with PostScript instructions. Therefore, the amount of
  286.           output data can be quit large especially if multiple image files are
  287.           specified or if the images are large. The size of the output file
  288.           should be kept in mind when sending the PostScript output over a
  289.           slow communications channel such as a serial line.
  290.  
  291.      3.   If _s_t_i_f_f_2_p_s is given an unrecognized or incomplete command line
  292.           option switch, it will print a warning message to the standard
  293.           error, ignore the option and continue processing.
  294.  
  295.      4.   If an image file is specified on the command line, _s_t_i_f_f_2_p_s will not
  296.           read its stdin for images.
  297.  
  298.      5.   Processing a planar STIFF image file requires random seeking within
  299.           the file.  Therefore, when _s_t_i_f_f_2_p_s is reading planar STIFF image
  300.           data from a pipe to standard input, a disk based copy of the input
  301.           image must be created.  This temporary image file will be created in
  302.           the directory specified by the TTTTMMMMPPPPDDDDIIIIRRRR environment variable. If that
  303.           variable is not set, the temporary file will be created in /_v_a_r/_t_m_p.
  304.           There must be sufficient free space in the temporary file directory
  305.           to store a complete copy of the image file or _s_t_i_f_f_2_p_s will fail.
  306.  
  307.      6.   _s_t_i_f_f_2_p_s can only process a single image file when reading from
  308.           standard input.
  309.  
  310. FFFFIIIILLLLEEEESSSS
  311.      /usr/lib/print/stiff2ps              Program file
  312.      /usr/lib/print/data/PSImageProlog    PostScript prolog file
  313.  
  314. TTTTRRRRAAAADDDDEEEEMMMMAAAARRRRKKKKSSSS
  315.      PostScript is a registered trademark of Adobe Systems, Inc.
  316.  
  317. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  318.      psrip(1), sgi2ps(1), _P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l - 2nd ed.,
  319.      Adobe Systems, Inc.
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.